SGAddFrameReference(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Utility Functions for Sequence Grabber Channel Components

SGAddFrameReference
The SGAddFrameReference function allows your channel component to store sample references.
pascal ComponentResult SGAddFrameReference (SeqGrabComponent s,
                                     SeqGrabFrameInfo *frameInfo);
s
Contains a component instance that identifies the sequence grabber component that has connected to your channel component. The sequence grabber component provides this value to your channel component when it calls your SGInitChannel function (described on page 6-36).
frameInfo
Contains a pointer to a frame information structure (defined by the SeqGrabFrameInfo data type). Your component must completely specify the reference by placing the appropriate information into the record referred to by this parameter. The format and content of the frame information structure are described on page 6-84.

DESCRIPTION
The sequence grabber component uses the information you provide to create a new sample reference in the movie that contains the captured data. You supply the information for the reference in a frame information structure.

RESULT CODES
Memory Manager errors

SEE ALSO
Your component can retrieve these references by calling the SGGetNextFrameReference function, which is described in the next section.